Array.length

Доступность

Flash Player 5.

Синтаксис

my_array.length:Number

Описание

Свойство; неотрицательное целое число, определяющее количество элементов в массиве. Это свойство автоматически обновляется, при добавлении новых элементов в массив. Когда Вы задаёте значение элементу массива (например, my_array[index] = value), если index - число, и index+1 больше, чем свойство length , свойство length обновляется до index+1.

Примечание: если Вы назначаете свойству length значение меньшее, чем существующая длина массива, то все лишние элементы будут удалены.

Пример

Следующий код объясняет, как обновляется свойство length :

var my_array:Array = new Array();
trace(my_array.length); // начальная величина length - 0
my_array[0] = 'a';
trace(my_array.length); // my_array.length обновлено до 1
my_array[1] = 'b';
trace(my_array.length); // my_array.length обновлено до 2
my_array[9] = 'c';
trace(my_array.length); // my_array.length обновлено до 10
trace(my_array); 
// выводится: 
// a,b,undefined,undefined,undefined,undefined,undefined,undefined,undefined,c

// если свойству length назначить величину 5, массив будет обрезан
my_array.length = 5; 
trace(my_array.length); // my_array.length обновлено до 5
trace(my_array); // выводится: a,b,undefined,undefined,undefined